
<!DOCTYPE HTML>
<html lang="zh-hans" >
    <head>
        <meta charset="UTF-8">
        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
        <title>编写高质量可维护的代码：一目了然的注释 · 记录技术文档内容</title>
        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
        <meta name="description" content="">
        <meta name="generator" content="GitBook 3.2.3">
        <meta name="author" content="zhengyuliang">
        
        
    
    <link rel="stylesheet" href="../gitbook/style.css">

    
            
                
                <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/css/bootstrap.min.css">
                
            
                
                <link rel="stylesheet" href="../gitbook/gitbook-plugin-sectionx/sectionx.css">
                
            
                
                <link rel="stylesheet" href="../gitbook/gitbook-plugin-splitter/splitter.css">
                
            
                
                <link rel="stylesheet" href="../gitbook/gitbook-plugin-tbfed-pagefooter/footer.css">
                
            
                
                <link rel="stylesheet" href="../gitbook/gitbook-plugin-toggle-chapters/toggle.css">
                
            
                
                <link rel="stylesheet" href="../gitbook/gitbook-plugin-search-plus/search.css">
                
            
                
                <link rel="stylesheet" href="../gitbook/gitbook-plugin-donate/plugin.css">
                
            
                
                <link rel="stylesheet" href="../gitbook/gitbook-plugin-anchor-navigation-ex/style/plugin.css">
                
            
                
                <link rel="stylesheet" href="../gitbook/gitbook-plugin-expandable-chapters/expandable-chapters.css">
                
            
                
                <link rel="stylesheet" href="../gitbook/gitbook-plugin-chapter-fold/chapter-fold.css">
                
            
                
                <link rel="stylesheet" href="../gitbook/gitbook-plugin-expandable-chapters-small/expandable-chapters-small.css">
                
            
                
                <link rel="stylesheet" href="../gitbook/gitbook-plugin-highlight/website.css">
                
            
                
                <link rel="stylesheet" href="../gitbook/gitbook-plugin-fontsettings/website.css">
                
            
                
                <link rel="stylesheet" href="../gitbook/gitbook-plugin-theme-comscore/test.css">
                
            
        

    

    
        
    
        
    
        
    
        
    
        
    
        
    

        
    
    
    <meta name="HandheldFriendly" content="true"/>
    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
    <meta name="apple-mobile-web-app-capable" content="yes">
    <meta name="apple-mobile-web-app-status-bar-style" content="black">
    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="../gitbook/images/apple-touch-icon-precomposed-152.png">
    <link rel="shortcut icon" href="../gitbook/images/favicon.ico" type="image/x-icon">

    
    <link rel="next" href="编写高质量可维护的代码：优化逻辑判断.html" />
    
    
    <link rel="prev" href="灵活运用JS开发技巧.html" />
    

    </head>
    <body>
        
<div class="book">
    <div class="book-summary">
        
            
<div id="book-search-input" role="search">
    <input type="text" placeholder="输入并搜索" />
</div>

            
                <nav role="navigation">
                


<ul class="summary">
    
    

    

    
        
        <li class="header">CSS</li>
        
        
    
        <li class="chapter " data-level="1.1" data-path="../">
            
                <a href="../">
            
                    
                    Introduction
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.2" data-path="../CSS/18种CSS命名和书写规范.html">
            
                <a href="../CSS/18种CSS命名和书写规范.html">
            
                    
                    18种CSS命名和书写规范
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.3" data-path="../CSS/灵活运用CSS开发技巧.html">
            
                <a href="../CSS/灵活运用CSS开发技巧.html">
            
                    
                    灵活运用CSS开发技巧
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.4" data-path="../CSS/自适应 flex grid.html">
            
                <a href="../CSS/自适应 flex grid.html">
            
                    
                    自适应 Flex Grid
            
                </a>
            

            
        </li>
    

    
        
        <li class="header">HTML</li>
        
        
    
        <li class="chapter " data-level="2.1" data-path="../HTML/浏览器里的本地数据库：IndexedDB.html">
            
                <a href="../HTML/浏览器里的本地数据库：IndexedDB.html">
            
                    
                    浏览器里的本地数据库：IndexedDB
            
                </a>
            

            
        </li>
    

    
        
        <li class="header">Vue</li>
        
        
    
        <li class="chapter " data-level="3.1" data-path="../Vue/7个有用的Vue开发技巧.html">
            
                <a href="../Vue/7个有用的Vue开发技巧.html">
            
                    
                    7个有用的Vue开发技巧
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="3.2" data-path="../Vue/Vue this.$router.push、replace、go的区别.html">
            
                <a href="../Vue/Vue this.$router.push、replace、go的区别.html">
            
                    
                    Vue This.$Router.Push、Replace、Go的区别
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="3.3" data-path="../Vue/Vue 的父组件和子组件生命周期钩子函数执行顺序？.html">
            
                <a href="../Vue/Vue 的父组件和子组件生命周期钩子函数执行顺序？.html">
            
                    
                    Vue 的父组件和子组件生命周期钩子函数执行顺序？
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="3.4" data-path="../Vue/Vue.set和this.$set应用的场景.html">
            
                <a href="../Vue/Vue.set和this.$set应用的场景.html">
            
                    
                    Vue.Set和This.$Set应用的场景
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="3.5" data-path="../Vue/vue高级技巧.html">
            
                <a href="../Vue/vue高级技巧.html">
            
                    
                    Vue高级技巧
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="3.6" data-path="../Vue/从 0 开始手把手带你搭建一套规范的 Vue3.x 项目工程环境.html">
            
                <a href="../Vue/从 0 开始手把手带你搭建一套规范的 Vue3.x 项目工程环境.html">
            
                    
                    从 0 开始手把手带你搭建一套规范的 Vue3.X 项目工程环境
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="3.7" data-path="../Vue/浅析 vue-router 源码和动态路由权限分配.html">
            
                <a href="../Vue/浅析 vue-router 源码和动态路由权限分配.html">
            
                    
                    浅析 Vue Router 源码和动态路由权限分配
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="3.8" data-path="../Vue/父组件监听到子组件的生命周期.html">
            
                <a href="../Vue/父组件监听到子组件的生命周期.html">
            
                    
                    父组件监听到子组件的生命周期
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="3.9" data-path="../Vue/理解Vue.mixin，利用Vue.mixin正确的偷懒.html">
            
                <a href="../Vue/理解Vue.mixin，利用Vue.mixin正确的偷懒.html">
            
                    
                    理解Vue.Mixin，利用Vue.Mixin正确的偷懒
            
                </a>
            

            
        </li>
    

    
        
        <li class="header">JavaScript</li>
        
        
    
        <li class="chapter " data-level="4.1" data-path="5个技巧让你更好的编写 JavaScript(ES6">
            
                <span>
            
                    
                    5个技巧让你更好的编写 JavaScript(ES6) 中条件语句
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="4.2" data-path="5种常见函数的写法和调用方式.html">
            
                <a href="5种常见函数的写法和调用方式.html">
            
                    
                    5种常见函数的写法和调用方式
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="4.3" data-path="7道javascript题，让你理解基本的javascript.html">
            
                <a href="7道javascript题，让你理解基本的javascript.html">
            
                    
                    7道Javascript题，让你理解基本的Javascript
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="4.4" data-path="Array.from(">
            
                <span>
            
                    
                    Array.From() 五个超好用的用途
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="4.5" data-path="ES6汇总资料.html">
            
                <a href="ES6汇总资料.html">
            
                    
                    ES6汇总资料
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="4.6" data-path="JS开发必须知道的41个技巧.html">
            
                <a href="JS开发必须知道的41个技巧.html">
            
                    
                    JS开发必须知道的41个技巧
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="4.7" data-path="JavaScript之防抖Debounce和节流Throttle.html">
            
                <a href="JavaScript之防抖Debounce和节流Throttle.html">
            
                    
                    JavaScript之防抖Debounce和节流Throttle
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="4.8" data-path="JavaScript数组求并集，交集和差集.html">
            
                <a href="JavaScript数组求并集，交集和差集.html">
            
                    
                    JavaScript数组求并集，交集和差集
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="4.9" data-path="JavaScript的优雅写法.html">
            
                <a href="JavaScript的优雅写法.html">
            
                    
                    JavaScript的优雅写法
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="4.10" data-path="axios知识点.html">
            
                <a href="axios知识点.html">
            
                    
                    Axios知识点
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="4.11" data-path="javascript核心知识.html">
            
                <a href="javascript核心知识.html">
            
                    
                    Javascript核心知识
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="4.12" data-path="this、apply、call、bind.html">
            
                <a href="this、apply、call、bind.html">
            
                    
                    This、Apply、Call、Bind
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="4.13" data-path="前端js常用的60余种工具方法.html">
            
                <a href="前端js常用的60余种工具方法.html">
            
                    
                    前端Js常用的60余种工具方法
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="4.14" data-path="前端异常的捕获与处理.html">
            
                <a href="前端异常的捕获与处理.html">
            
                    
                    前端异常的捕获与处理
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="4.15" data-path="在 JavaScript 中交换值的 10 种方法.html">
            
                <a href="在 JavaScript 中交换值的 10 种方法.html">
            
                    
                    在 JavaScript 中交换值的 10 种方法
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="4.16" data-path="常用的前端JavaScript方法封装.html">
            
                <a href="常用的前端JavaScript方法封装.html">
            
                    
                    常用的前端JavaScript方法封装
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="4.17" data-path="异步神器Async-await介绍与填坑.html">
            
                <a href="异步神器Async-await介绍与填坑.html">
            
                    
                    异步神器Async Await介绍与填坑
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="4.18" data-path="灵活运用JS开发技巧.html">
            
                <a href="灵活运用JS开发技巧.html">
            
                    
                    灵活运用JS开发技巧
            
                </a>
            

            
        </li>
    
        <li class="chapter active" data-level="4.19" data-path="编写高质量可维护的代码：一目了然的注释.html">
            
                <a href="编写高质量可维护的代码：一目了然的注释.html">
            
                    
                    编写高质量可维护的代码：一目了然的注释
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="4.20" data-path="编写高质量可维护的代码：优化逻辑判断.html">
            
                <a href="编写高质量可维护的代码：优化逻辑判断.html">
            
                    
                    编写高质量可维护的代码：优化逻辑判断
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="4.21" data-path="编写高质量可维护的代码：优雅命名.html">
            
                <a href="编写高质量可维护的代码：优雅命名.html">
            
                    
                    编写高质量可维护的代码：优雅命名
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="4.22" data-path="编写高质量可维护的代码：数据建模.html">
            
                <a href="编写高质量可维护的代码：数据建模.html">
            
                    
                    编写高质量可维护的代码：数据建模
            
                </a>
            

            
        </li>
    

    
        
        <li class="header">Life Exp</li>
        
        
    
        <li class="chapter " data-level="5.1" data-path="../life_exp/告别平庸的15个小方法.html">
            
                <a href="../life_exp/告别平庸的15个小方法.html">
            
                    
                    告别平庸的15个小方法
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="5.2" data-path="../life_exp/日志记录.html">
            
                <a href="../life_exp/日志记录.html">
            
                    
                    日志记录
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="5.3" data-path="../life_exp/程序员的发展方向.html">
            
                <a href="../life_exp/程序员的发展方向.html">
            
                    
                    程序员的发展方向
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="5.4" data-path="../message/">
            
                <a href="../message/">
            
                    
                    Message
            
                </a>
            

            
        </li>
    

    
        
        <li class="header">Technology</li>
        
        
    
        <li class="chapter " data-level="6.1" data-path="../technology/WebSocket.html">
            
                <a href="../technology/WebSocket.html">
            
                    
                    WebSocket
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="6.2" data-path="../technology/npm常用命令大全.html">
            
                <a href="../technology/npm常用命令大全.html">
            
                    
                    Npm常用命令大全
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="6.3" data-path="../technology/智能照明项目说明.html">
            
                <a href="../technology/智能照明项目说明.html">
            
                    
                    智能照明项目说明
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="6.4" data-path="../technology/规范化git的提交信息.html">
            
                <a href="../technology/规范化git的提交信息.html">
            
                    
                    规范化Git的提交信息
            
                </a>
            

            
        </li>
    

    
        
        <li class="header">Tutorial</li>
        
        
    
        <li class="chapter " data-level="7.1" data-path="../tutorial/Esmap地图详解.html">
            
                <a href="../tutorial/Esmap地图详解.html">
            
                    
                    Esmap地图详解
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="7.2" data-path="../tutorial/npm镜像切换.html">
            
                <a href="../tutorial/npm镜像切换.html">
            
                    
                    Npm镜像切换
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="7.3" data-path="../tutorial/发布npm的教程.html">
            
                <a href="../tutorial/发布npm的教程.html">
            
                    
                    发布Npm的教程
            
                </a>
            

            
        </li>
    

    

    <li class="divider"></li>

    <li>
        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
            本书使用 GitBook 发布
        </a>
    </li>
</ul>


                </nav>
            
        
    </div>

    <div class="book-body">
        
            <div class="body-inner">
                
                    

<div class="book-header" role="navigation">
    

    <!-- Title -->
    <h1>
        <i class="fa fa-circle-o-notch fa-spin"></i>
        <a href=".." >编写高质量可维护的代码：一目了然的注释</a>
    </h1>
</div>




                    <div class="page-wrapper" tabindex="-1" role="main">
                        <div class="page-inner">
                            
<div class="search-plus" id="book-search-results">
    <div class="search-noresults">
    
                                <section class="normal markdown-section">
                                
                                <html><head></head><body><div id="anchor-navigation-ex-navbar"><i class="fa fa-navicon"></i><ul><li><span class="title-icon "></span><a href="#&#x7F16;&#x5199;&#x9AD8;&#x8D28;&#x91CF;&#x53EF;&#x7EF4;&#x62A4;&#x7684;&#x4EE3;&#x7801;&#xFF1A;&#x4E00;&#x76EE;&#x4E86;&#x7136;&#x7684;&#x6CE8;&#x91CA;"><b>1. </b>&#x7F16;&#x5199;&#x9AD8;&#x8D28;&#x91CF;&#x53EF;&#x7EF4;&#x62A4;&#x7684;&#x4EE3;&#x7801;&#xFF1A;&#x4E00;&#x76EE;&#x4E86;&#x7136;&#x7684;&#x6CE8;&#x91CA;</a></li><ul><ul><li><span class="title-icon "></span><a href="#&#x524D;&#x8A00;"><b>1.1.1. </b>&#x524D;&#x8A00;</a></li><li><span class="title-icon "></span><a href="#&#x7F16;&#x7A0B;&#x8BED;&#x8A00;&#x4E2D;&#x5BF9;&#x6CE8;&#x91CA;&#x7684;&#x89E3;&#x91CA;"><b>1.1.2. </b>&#x7F16;&#x7A0B;&#x8BED;&#x8A00;&#x4E2D;&#x5BF9;&#x201C;&#x6CE8;&#x91CA;&#x201D;&#x7684;&#x89E3;&#x91CA;</a></li><li><span class="title-icon "></span><a href="#&#x8981;&#x4E0D;&#x8981;&#x52A0;&#x6CE8;&#x91CA;&#xFF1F;&#x4E3A;&#x4EC0;&#x4E48;&#x8981;&#x52A0;&#x6CE8;&#x91CA;&#xFF1F;"><b>1.1.3. </b>&#x8981;&#x4E0D;&#x8981;&#x52A0;&#x6CE8;&#x91CA;&#xFF1F;&#x4E3A;&#x4EC0;&#x4E48;&#x8981;&#x52A0;&#x6CE8;&#x91CA;&#xFF1F;</a></li><li><span class="title-icon "></span><a href="#&#x57FA;&#x7840;&#x7BC7;"><b>1.1.4. </b>&#x57FA;&#x7840;&#x7BC7;</a></li><li><span class="title-icon "></span><a href="#&#x62D3;&#x5C55;&#x7BC7;"><b>1.1.5. </b>&#x62D3;&#x5C55;&#x7BC7;</a></li><li><span class="title-icon "></span><a href="#&#x6CE8;&#x91CA;&#x76F8;&#x5173;&#x63D2;&#x4EF6;"><b>1.1.6. </b>&#x6CE8;&#x91CA;&#x76F8;&#x5173;&#x63D2;&#x4EF6;</a></li><li><span class="title-icon "></span><a href="#&#x7528;&#x4E8B;&#x5B9E;&#x8BF4;&#x8BDD;"><b>1.1.7. </b>&#x7528;&#x4E8B;&#x5B9E;&#x8BF4;&#x8BDD;</a></li><li><span class="title-icon "></span><a href="#&#x7ED3;&#x8BED;"><b>1.1.8. </b>&#x7ED3;&#x8BED;</a></li></ul></ul></ul></div><a href="#&#x7F16;&#x5199;&#x9AD8;&#x8D28;&#x91CF;&#x53EF;&#x7EF4;&#x62A4;&#x7684;&#x4EE3;&#x7801;&#xFF1A;&#x4E00;&#x76EE;&#x4E86;&#x7136;&#x7684;&#x6CE8;&#x91CA;" id="anchorNavigationExGoTop"><i class="fa fa-arrow-up"></i></a><h1 id="&#x7F16;&#x5199;&#x9AD8;&#x8D28;&#x91CF;&#x53EF;&#x7EF4;&#x62A4;&#x7684;&#x4EE3;&#x7801;&#xFF1A;&#x4E00;&#x76EE;&#x4E86;&#x7136;&#x7684;&#x6CE8;&#x91CA;"><a name="&#x7F16;&#x5199;&#x9AD8;&#x8D28;&#x91CF;&#x53EF;&#x7EF4;&#x62A4;&#x7684;&#x4EE3;&#x7801;&#xFF1A;&#x4E00;&#x76EE;&#x4E86;&#x7136;&#x7684;&#x6CE8;&#x91CA;" class="anchor-navigation-ex-anchor" href="#&#x7F16;&#x5199;&#x9AD8;&#x8D28;&#x91CF;&#x53EF;&#x7EF4;&#x62A4;&#x7684;&#x4EE3;&#x7801;&#xFF1A;&#x4E00;&#x76EE;&#x4E86;&#x7136;&#x7684;&#x6CE8;&#x91CA;"><i class="fa fa-link" aria-hidden="true"></i></a>1. &#x7F16;&#x5199;&#x9AD8;&#x8D28;&#x91CF;&#x53EF;&#x7EF4;&#x62A4;&#x7684;&#x4EE3;&#x7801;&#xFF1A;&#x4E00;&#x76EE;&#x4E86;&#x7136;&#x7684;&#x6CE8;&#x91CA;</h1>
<p>[TOC]</p>
<h3 id="&#x524D;&#x8A00;"><a name="&#x524D;&#x8A00;" class="anchor-navigation-ex-anchor" href="#&#x524D;&#x8A00;"><i class="fa fa-link" aria-hidden="true"></i></a>1.1.1. &#x524D;&#x8A00;</h3>
<p>&#x6709;&#x4E00;&#x4E9B;&#x4EBA;&#x8BA4;&#x4E3A;&#xFF0C;&#x597D;&#x7684;&#x4EE3;&#x7801;&#x662F;&#x81EA;&#x6211;&#x89E3;&#x91CA;&#x7684;&#x3002;&#x5408;&#x9002;&#x7684;&#x547D;&#x540D;&#x548C;&#x4F18;&#x79C0;&#x7684;&#x4EE3;&#x7801;&#x7684;&#x786E;&#x53EF;&#x4EE5;&#x51CF;&#x8F7B;&#x5F00;&#x53D1;&#x4EBA;&#x5458;&#x9605;&#x8BFB;&#x4EE3;&#x7801;&#x7684;&#x5DE5;&#x4F5C;&#x91CF;&#xFF0C;&#x5BF9;&#x4E8E;&#x4E0D;&#x662F;&#x7279;&#x522B;&#x590D;&#x6742;&#x7684;&#x4EE3;&#x7801;&#x53EF;&#x80FD;&#x786E;&#x5B9E;&#x53EF;&#x4EE5;&#x505A;&#x5230;&#x81EA;&#x6211;&#x89E3;&#x91CA;&#x3002;&#x4F46;&#x5E76;&#x4E0D;&#x662F;&#x6240;&#x6709;&#x573A;&#x666F;&#x90FD;&#x53EF;&#x4EE5;&#x505A;&#x5230;&#x8FD9;&#x4E00;&#x70B9;&#xFF0C;&#x6211;&#x4EEC;&#x4E00;&#x8D77;&#x6765;&#x4E86;&#x89E3;&#x4E00;&#x4E0B;&#x201C;&#x6CE8;&#x91CA;&#x201D;&#x5427;&#x3002;</p>
<h3 id="&#x7F16;&#x7A0B;&#x8BED;&#x8A00;&#x4E2D;&#x5BF9;&#x6CE8;&#x91CA;&#x7684;&#x89E3;&#x91CA;"><a name="&#x7F16;&#x7A0B;&#x8BED;&#x8A00;&#x4E2D;&#x5BF9;&#x6CE8;&#x91CA;&#x7684;&#x89E3;&#x91CA;" class="anchor-navigation-ex-anchor" href="#&#x7F16;&#x7A0B;&#x8BED;&#x8A00;&#x4E2D;&#x5BF9;&#x6CE8;&#x91CA;&#x7684;&#x89E3;&#x91CA;"><i class="fa fa-link" aria-hidden="true"></i></a>1.1.2. &#x7F16;&#x7A0B;&#x8BED;&#x8A00;&#x4E2D;&#x5BF9;&#x201C;&#x6CE8;&#x91CA;&#x201D;&#x7684;&#x89E3;&#x91CA;</h3>
<p>&#x6CE8;&#x91CA;&#x5C31;&#x662F;&#x5BF9;&#x4EE3;&#x7801;&#x7684;&#x89E3;&#x91CA;&#x548C;&#x8BF4;&#x660E;&#x3002;&#x6CE8;&#x91CA;&#x662F;&#x5F00;&#x53D1;&#x4EBA;&#x5458;&#x5728;&#x7F16;&#x5199;&#x7A0B;&#x5E8F;&#x65F6;&#xFF0C;&#x7ED9;&#x4E00;&#x6BB5;&#x4EE3;&#x7801;&#x7684;&#x89E3;&#x91CA;&#x6216;&#x63D0;&#x793A;&#xFF0C;&#x6709;&#x52A9;&#x4E8E;&#x63D0;&#x9AD8;&#x7A0B;&#x5E8F;&#x4EE3;&#x7801;&#x7684;&#x53EF;&#x8BFB;&#x6027;&#x3002;&#x6CE8;&#x91CA;&#x4E0D;&#x4F1A;&#x88AB;&#x8BA1;&#x7B97;&#x673A;&#x7F16;&#x8BD1;&#x3002;</p>
<h3 id="&#x8981;&#x4E0D;&#x8981;&#x52A0;&#x6CE8;&#x91CA;&#xFF1F;&#x4E3A;&#x4EC0;&#x4E48;&#x8981;&#x52A0;&#x6CE8;&#x91CA;&#xFF1F;"><a name="&#x8981;&#x4E0D;&#x8981;&#x52A0;&#x6CE8;&#x91CA;&#xFF1F;&#x4E3A;&#x4EC0;&#x4E48;&#x8981;&#x52A0;&#x6CE8;&#x91CA;&#xFF1F;" class="anchor-navigation-ex-anchor" href="#&#x8981;&#x4E0D;&#x8981;&#x52A0;&#x6CE8;&#x91CA;&#xFF1F;&#x4E3A;&#x4EC0;&#x4E48;&#x8981;&#x52A0;&#x6CE8;&#x91CA;&#xFF1F;"><i class="fa fa-link" aria-hidden="true"></i></a>1.1.3. &#x8981;&#x4E0D;&#x8981;&#x52A0;&#x6CE8;&#x91CA;&#xFF1F;&#x4E3A;&#x4EC0;&#x4E48;&#x8981;&#x52A0;&#x6CE8;&#x91CA;&#xFF1F;</h3>
<p>&#x6CE8;&#x91CA;&#x7684;&#x5B58;&#x5728;&#x5C31;&#x662F;&#x4E3A;&#x4E86;&#x65B9;&#x4FBF;&#x81EA;&#x5DF1;&#x7684;&#x4E8C;&#x6B21;&#x9605;&#x8BFB;&#x548C;&#x4EE3;&#x7801;&#x7EF4;&#x62A4;&#x4EE5;&#x53CA;&#x9879;&#x76EE;&#x4EA4;&#x63A5;&#x3002;&#x53EF;&#x4EE5;&#x66F4;&#x597D;&#x7684;&#x7406;&#x89E3;&#x4EE3;&#x7801;&#xFF0C;&#x6709;&#x52A9;&#x4E8E;&#x63D0;&#x9AD8;&#x534F;&#x4F5C;&#x6548;&#x7387;&#xFF0C;&#x52A0;&#x5FEB;&#x5F00;&#x53D1;&#x8FDB;&#x7A0B;&#x3002;</p>
<p>&#x8BD5;&#x60F3;&#xFF0C;&#x4F60;&#x6DFB;&#x52A0;&#x4E86;&#x4E00;&#x6BB5;&#x903B;&#x8F91;&#x8F83;&#x4E3A;&#x590D;&#x6742;&#x7684;&#x4EE3;&#x7801;&#xFF0C;&#x51E0;&#x4E2A;&#x6708;&#x540E;&#x518D;&#x770B;&#xFF0C;&#x8FD8;&#x80FD;&#x4E0D;&#x80FD;&#x8FC5;&#x901F;&#x770B;&#x61C2;&#xFF1F;&#x4F60;&#x521A;&#x521A;&#x63A5;&#x624B;&#x4E00;&#x4E2A;&#x8001;&#x9879;&#x76EE;&#xFF0C;&#x9879;&#x76EE;&#x91CC;&#x57FA;&#x672C;&#x6CA1;&#x6709;&#x6CE8;&#x91CA;&#x4E14;&#x903B;&#x8F91;&#x590D;&#x6742;&#xFF0C;&#x4F60;&#x80FD;&#x9AD8;&#x6548;&#x7387;&#x7684;&#x770B;&#x61C2;&#x4EE3;&#x7801;&#x548C;&#x4E86;&#x89E3;&#x4E1A;&#x52A1;&#x5417;&#xFF1F;</p>
<p>&#x6240;&#x4EE5;&#x6DFB;&#x52A0;&#x6CE8;&#x91CA;&#x8FD8;&#x662F;&#x6709;&#x4E00;&#x5B9A;&#x5FC5;&#x8981;&#x6EF4;&#x3002;</p>
<h3 id="&#x57FA;&#x7840;&#x7BC7;"><a name="&#x57FA;&#x7840;&#x7BC7;" class="anchor-navigation-ex-anchor" href="#&#x57FA;&#x7840;&#x7BC7;"><i class="fa fa-link" aria-hidden="true"></i></a>1.1.4. &#x57FA;&#x7840;&#x7BC7;</h3>
<blockquote>
<p>&#x5FEB;&#x6377;&#x952E; windows&#xFF1A; ctrl+/ mac&#xFF1A; command+/</p>
</blockquote>
<h4 id="&#x6CE8;&#x91CA;&#x7684;&#x5206;&#x7C7B;"><a name="&#x6CE8;&#x91CA;&#x7684;&#x5206;&#x7C7B;" class="anchor-navigation-ex-anchor" href="#&#x6CE8;&#x91CA;&#x7684;&#x5206;&#x7C7B;"><i class="fa fa-link" aria-hidden="true"></i></a>&#x6CE8;&#x91CA;&#x7684;&#x5206;&#x7C7B;</h4>
<p>&#x4E00;&#x3001; HTML &#x4E2D;&#x7684;&#x6CE8;&#x91CA;</p>
<pre><code class="lang-html"><span class="hljs-tag">&lt;<span class="hljs-name">div</span>&gt;</span>
      &#x8FD9;&#x662F;&#x4E00;&#x884C;&#x6587;&#x5B57;
      <span class="hljs-comment">&lt;!-- &#x8FD9;&#x662F;&#x4E00;&#x884C;&#x88AB;&#x6CE8;&#x91CA;&#x7684;&#x6587;&#x5B57; --&gt;</span>
<span class="hljs-tag">&lt;/<span class="hljs-name">div</span>&gt;</span>
</code></pre>
<p>&#x4E8C;&#x3001;CSS &#x4E2D;&#x7684;&#x6CE8;&#x91CA;</p>
<ul>
<li>&#x5728; .html &#x6587;&#x4EF6;&#x4E2D;</li>
</ul>
<pre><code class="lang-html"><span class="hljs-tag">&lt;<span class="hljs-name">style</span>&gt;</span><span class="css">
  <span class="hljs-selector-tag">div</span> {
      <span class="hljs-comment">/* color: #fff;  */</span>
   }
</span><span class="hljs-tag">&lt;/<span class="hljs-name">style</span>&gt;</span>
</code></pre>
<ul>
<li>&#x5728; .css &#x6587;&#x4EF6;&#x4E2D;</li>
</ul>
<pre><code class="lang-css"><span class="hljs-selector-tag">div</span> {
    <span class="hljs-comment">/* color: #fff;  */</span>
}
</code></pre>
<ul>
<li>&#x5728; .less &#x6216; .scss &#x6587;&#x4EF6;&#x4E2D;</li>
</ul>
<pre><code class="lang-less"><span class="hljs-selector-tag">div</span> {
    <span class="hljs-comment">/* color: #fff;*/</span>  <span class="hljs-comment">/* &#x591A;&#x884C;&#x6CE8;&#x91CA;*/</span>
    <span class="hljs-comment">// font-size: 14px; // &#x5355;&#x884C;&#x6CE8;&#x91CA;</span>
    <span class="hljs-attribute">background</span>: <span class="hljs-number">#000</span>;
}
</code></pre>
<p>&#x4E09;&#x3001;JS &#x4E2D;&#x7684;&#x6CE8;&#x91CA;</p>
<ul>
<li>&#x7528;&#x6CD5;<ul>
<li>&#x53EF;&#x7528;&#x4E8E;&#x89E3;&#x91CA; JavaScript &#x4EE3;&#x7801;&#xFF0C;&#x589E;&#x5F3A;&#x5176;&#x53EF;&#x8BFB;&#x6027;&#x3002;</li>
<li>&#x4E5F;&#x53EF;&#x4EE5;&#x7528;&#x4E8E;&#x963B;&#x6B62;&#x4EE3;&#x7801;&#x6267;&#x884C;&#x3002;</li>
</ul>
</li>
<li>&#x5355;&#x884C;&#x6CE8;&#x91CA;&#xFF08;&#x884C;&#x6CE8;&#x91CA;&#xFF09;&#x2014;&#x2014; &#x4EE5; <code>//</code>&#x5F00;&#x5934;&#x3002;&#x4EFB;&#x4F55;&#x4F4D;&#x4E8E; <code>//</code> &#x4E4B;&#x540E;&#x7684;&#x6587;&#x672C;&#x90FD;&#x4F1A;&#x88AB;&#x6CE8;&#x91CA;</li>
</ul>
<pre><code class="lang-js"><span class="hljs-comment">// &#x5B9A;&#x4E49;&#x4E00;&#x4E2A;&#x7A7A;&#x6570;&#x7EC4;</span>
<span class="hljs-keyword">var</span> ary = [];
<span class="hljs-keyword">var</span> ary2 = []; <span class="hljs-comment">// &#x53C8;&#x5B9A;&#x4E49;&#x4E00;&#x4E2A;&#x7A7A;&#x6570;&#x7EC4;</span>
</code></pre>
<ul>
<li>&#x591A;&#x884C;&#x6CE8;&#x91CA;&#xFF08;&#x5757;&#x6CE8;&#x91CA;&#xFF09;&#x2014;&#x2014;&#x4EE5; <code>/*</code> &#x5F00;&#x5934;&#xFF0C;&#x4EE5; <code>*/</code> &#x7ED3;&#x5C3E;&#x3002;&#x4EFB;&#x4F55;&#x4F4D;&#x4E8E; <code>/*</code> &#x548C; <code>*/</code> &#x4E4B;&#x95F4;&#x7684;&#x6587;&#x672C;&#x90FD;&#x4F1A;&#x88AB;&#x6CE8;&#x91CA;</li>
</ul>
<pre><code class="lang-js"><span class="hljs-comment">/*
    &#x8FD9;&#x662F;&#x591A;&#x884C;&#x6CE8;&#x91CA;
    &#x5B9A;&#x4E49;&#x4E00;&#x4E2A;&#x6570;&#x7EC4;
 */</span>
<span class="hljs-keyword">var</span> ary = [];
</code></pre>
<ul>
<li>&#x7528;&#x6CE8;&#x91CA;&#x6765;&#x963B;&#x6B62;&#x4EE3;&#x7801;&#x6267;&#x884C; &#x2014;&#x2014; &#x88AB;&#x6CE8;&#x91CA;&#x7684; JS &#x4EE3;&#x7801;&#x5C06;&#x4E0D;&#x88AB;&#x6267;&#x884C;</li>
</ul>
<pre><code class="lang-js"><span class="hljs-comment">//alert(&quot;123&quot;)  // &#x6267;&#x884C;&#x65F6;&#x672A;&#x5F39;&#x51FA;&#x8BE5;&#x4FE1;&#x606F;</span>
alert(<span class="hljs-string">&quot;456&quot;</span>)  <span class="hljs-comment">// &#x6267;&#x884C;&#x65F6;&#x5F39;&#x51FA;&#x8BE5;&#x4FE1;&#x606F;</span>
</code></pre>
<ul>
<li>&#x51FD;&#x6570;&#x6CE8;&#x91CA;<ul>
<li>&#x4E00;&#x822C;&#x4EE5; <code>/**</code> &#x5F00;&#x5934;&#xFF0C;&#x4EE5; <code>*/</code> &#x7ED3;&#x5C3E;&#x3002;&#x4EFB;&#x4F55;&#x4F4D;&#x4E8E; <code>/**</code> &#x548C; <code>*/</code> &#x4E4B;&#x95F4;&#x7684;&#x6587;&#x672C;&#x90FD;&#x4F1A;&#x88AB;&#x6CE8;&#x91CA;</li>
</ul>
</li>
</ul>
<pre><code class="lang-js"><span class="hljs-comment">/**
 * &#x63D0;&#x4EA4;
 *
 * @method onSubmit
 * @param {[Object]} &#x63D0;&#x4EA4;&#x6570;&#x636E;
 * @return  {[Bollean]}  [&#x8FD4;&#x56DE;&#x662F;&#x5426;&#x63D0;&#x4EA4;&#x6210;&#x529F; ]
 */</span>
<span class="hljs-keyword">const</span> onSubmit = <span class="hljs-function">(<span class="hljs-params">params = {}</span>) =&gt;</span> {
  <span class="hljs-keyword">const</span> result = <span class="hljs-literal">false</span>;
    <span class="hljs-keyword">if</span> (params) {
            result = <span class="hljs-literal">true</span>;
        }
    <span class="hljs-keyword">return</span> result;
};
</code></pre>
<p>&#x56DB;&#x3001;&#x7279;&#x6B8A;&#x6807;&#x8BB0;&#x6CE8;&#x91CA;</p>
<ul>
<li><strong>TODO </strong>&#x5728;&#x8BE5;&#x6CE8;&#x91CA;&#x5904;&#x6709;&#x529F;&#x80FD;&#x4EE3;&#x7801;&#x5F85;&#x7F16;&#x5199;&#xFF0C;&#x5F85;&#x5B9E;&#x73B0;&#x7684;&#x529F;&#x80FD;&#x5728;&#x8BF4;&#x660E;&#x4E2D;&#x4F1A;&#x7B80;&#x7565;&#x8BF4;&#x660E;</li>
<li><strong>FIXME</strong> &#x5728;&#x8BE5;&#x6CE8;&#x91CA;&#x5904;&#x4EE3;&#x7801;&#x9700;&#x8981;&#x4FEE;&#x6B63;&#xFF0C;&#x751A;&#x81F3;&#x4EE3;&#x7801;&#x662F;&#x9519;&#x8BEF;&#x7684;&#xFF0C;&#x4E0D;&#x80FD;&#x5DE5;&#x4F5C;&#xFF0C;&#x9700;&#x8981;&#x4FEE;&#x590D;&#xFF0C;&#x5982;&#x4F55;&#x4FEE;&#x6B63;&#x4F1A;&#x5728;&#x8BF4;&#x660E;&#x4E2D;&#x7B80;&#x7565;&#x8BF4;&#x660E;</li>
<li><strong>XXX </strong>&#x5728;&#x8BE5;&#x6CE8;&#x91CA;&#x5904;&#x4EE3;&#x7801;&#x867D;&#x7136;&#x5B9E;&#x73B0;&#x4E86;&#x529F;&#x80FD;&#xFF0C;&#x4F46;&#x662F;&#x5B9E;&#x73B0;&#x7684;&#x65B9;&#x6CD5;&#x6709;&#x5F85;&#x5546;&#x69B7;&#xFF0C;&#x5E0C;&#x671B;&#x5C06;&#x6765;&#x80FD;&#x6539;&#x8FDB;&#xFF0C;&#x8981;&#x6539;&#x8FDB;&#x7684;&#x5730;&#x65B9;&#x4F1A;&#x5728;&#x8BF4;&#x660E;&#x4E2D;&#x7B80;&#x7565;&#x8BF4;&#x660E;</li>
<li><strong>NOTE </strong>&#x5728;&#x8BE5;&#x6CE8;&#x91CA;&#x5904;&#x8BF4;&#x660E;&#x4EE3;&#x7801;&#x5982;&#x4F55;&#x5DE5;&#x4F5C;</li>
<li><strong>HACK </strong>&#x5728;&#x8BE5;&#x6CE8;&#x91CA;&#x5904;&#x7F16;&#x5199;&#x5F97;&#x4E0D;&#x597D;&#x6216;&#x683C;&#x5F0F;&#x9519;&#x8BEF;&#xFF0C;&#x9700;&#x8981;&#x6839;&#x636E;&#x81EA;&#x5DF1;&#x7684;&#x9700;&#x6C42;&#x53BB;&#x8C03;&#x6574;&#x7A0B;&#x5E8F;&#x4EE3;&#x7801;</li>
<li><strong>BUG </strong>&#x5728;&#x8BE5;&#x6CE8;&#x91CA;&#x5904;&#x6709; Bug</li>
</ul>
<pre><code class="lang-js"><span class="hljs-comment">// TODO&#x529F;&#x80FD;&#x672A;&#x5B8C;&#x6210;&#xFF0C;&#x5F85;&#x5B8C;&#x5584;</span>
<span class="hljs-comment">// FIXME  &#x5F85;&#x4FEE;&#x590D;</span>
<span class="hljs-comment">// XXX    &#x5B9E;&#x73B0;&#x65B9;&#x6CD5;&#x5F85;&#x786E;&#x8BA4;</span>
<span class="hljs-comment">// NOTE   &#x4EE3;&#x7801;&#x529F;&#x80FD;&#x8BF4;&#x660E;</span>
<span class="hljs-comment">// HACK   &#x6B64;&#x5904;&#x5199;&#x6CD5;&#x6709;&#x5F85;&#x4F18;&#x5316;</span>
<span class="hljs-comment">// BUG    &#x6B64;&#x5904;&#x6709; Bug</span>
<span class="hljs-keyword">const</span> arr = []
</code></pre>
<p>Tips&#xFF1A;</p>
<ul>
<li>&#x4E3A;&#x4EC0;&#x4E48; //  &#x6CE8;&#x91CA;&#x53EF;&#x4EE5;&#x5728; .less &#x6216; .scss &#x6587;&#x4EF6;&#x4E2D;&#x4F7F;&#x7528;&#xFF0C;&#x4F46;&#x662F;&#x5728; .html &#x548C; .css &#x6587;&#x4EF6;&#x4E2D;&#x4E0D;&#x751F;&#x6548;&#xFF1F;<ul>
<li>&#x5728; <a href="https://developer.mozilla.org/zh-CN/docs/Web/CSS/Comments" target="_blank">MDN</a> &#x4E2D;&#x5173;&#x4E8E; CSS &#x6CE8;&#x91CA;&#x53EA;&#x6709; <code>/* */</code> &#x4E00;&#x79CD;&#x8BED;&#x6CD5;&#x3002;&#x4F46;&#x662F;&#x5728; LESS &#x548C; SCSS &#x4E2D;&#x652F;&#x6301;&#x6CE8;&#x91CA;&#x7684;&#x8BED;&#x6CD5;&#x548C; JS &#x4E2D;&#x4FDD;&#x6301;&#x4E00;&#x81F4;&#xFF0C;&#x6709;&#x5355;&#x884C;&#x6CE8;&#x91CA; <code>//</code> &#x548C;&#x591A;&#x884C;&#x6CE8;&#x91CA; <code>/* */</code> &#x4E24;&#x79CD;&#x3002;&#x5355;&#x884C;&#x6CE8;&#x91CA;&#x7F16;&#x8BD1;&#x4E4B;&#x540E;&#x4E0D;&#x4F1A;&#x88AB;&#x4FDD;&#x7559;&#x3002;</li>
</ul>
</li>
<li>&#x5355;&#x884C;&#x6CE8;&#x91CA;&#x4E3A;&#x4EC0;&#x4E48;&#x6709;&#x65F6;&#x5019;&#x5199;&#x5728;&#x4EE3;&#x7801;&#x4E0A;&#x65B9;&#xFF0C;&#x6709;&#x65F6;&#x5019;&#x5199;&#x5728;&#x4EE3;&#x7801;&#x540E;&#x65B9;&#xFF1F;<ul>
<li>&#x6CE8;&#x91CA;&#x53EF;&#x4EE5;&#x4E66;&#x5199;&#x5728;&#x4EE3;&#x7801;&#x4E2D;&#x7684;&#x4EFB;&#x610F;&#x4F4D;&#x7F6E;&#x3002;&#x4E2A;&#x4EBA;&#x7406;&#x89E3;&#xFF0C;&#x4E00;&#x822C;&#x5199;&#x5728;&#x4EE3;&#x7801;&#x4E0A;&#x65B9;&#x7684;&#x65F6;&#x5019;&#x610F;&#x4E3A;&#x5BF9;&#x540E;&#x9762;&#x4E00;&#x6BB5;&#x4EE3;&#x7801;&#x7684;&#x6CE8;&#x91CA;&#xFF0C;&#x800C;&#x5199;&#x5728;&#x4EE3;&#x7801;&#x540E;&#x65B9;&#x7684;&#x65F6;&#x5019;&#x610F;&#x4E3A;&#x5BF9;&#x672C;&#x884C;&#x4EE3;&#x7801;&#x7684;&#x6CE8;&#x91CA;&#x3002;</li>
</ul>
</li>
</ul>
<h4 id="&#x6CE8;&#x91CA;&#x5199;&#x6CD5;&#x89C4;&#x8303;"><a name="&#x6CE8;&#x91CA;&#x5199;&#x6CD5;&#x89C4;&#x8303;" class="anchor-navigation-ex-anchor" href="#&#x6CE8;&#x91CA;&#x5199;&#x6CD5;&#x89C4;&#x8303;"><i class="fa fa-link" aria-hidden="true"></i></a>&#x6CE8;&#x91CA;&#x5199;&#x6CD5;&#x89C4;&#x8303;</h4>
<ul>
<li>&#x6587;&#x4EF6;&#x6CE8;&#x91CA;<ul>
<li>&#x4F4D;&#x4E8E;&#x6587;&#x4EF6;&#x5934;&#x90E8;&#xFF0C;&#x4E00;&#x822C;&#x5305;&#x542B;&#x6982;&#x8981;&#x3001;&#x4F5C;&#x8005;&#x3001;&#x7248;&#x672C;&#x6539;&#x52A8;&#x4FE1;&#x606F;&#x4EE5;&#x53CA;&#x4FEE;&#x6539;&#x65F6;&#x95F4;&#x7B49;&#x5185;&#x5BB9;</li>
</ul>
</li>
</ul>
<pre><code class="lang-js">  <span class="hljs-comment">/*
   * &#x7B80;&#x8FF0;&#x5F53;&#x524D;&#x6587;&#x4EF6;&#x529F;&#x80FD;
   * @author &#x4F5C;&#x8005;&#x540D;&#x79F0;
   * @version &#x7248;&#x672C;&#x53F7; &#x6700;&#x8FD1;&#x7F16;&#x8F91;&#x65F6;&#x95F4;
   * @description &#x8BE5;&#x7248;&#x672C;&#x6539;&#x52A8;&#x4FE1;&#x606F;
   */</span>
</code></pre>
<ul>
<li>&#x5355;&#x884C;&#x6CE8;&#x91CA;<ul>
<li>&#x603B;&#x662F;&#x5728; <code>//</code> &#x540E;&#x7559;&#x4E00;&#x4E2A;&#x7A7A;&#x683C;</li>
</ul>
</li>
</ul>
<pre><code class="lang-js">  <span class="hljs-comment">// &#x8FD9;&#x662F;&#x4E00;&#x884C;&#x6CE8;&#x91CA;</span>
</code></pre>
<ul>
<li>&#x591A;&#x884C;&#x6CE8;&#x91CA;<ul>
<li>&#x603B;&#x662F;&#x4FDD;&#x6301;&#x661F;&#x53F7;&#x7EB5;&#x5411;&#x5BF9;&#x9F50;&#xFF08;&#x7ED3;&#x675F;&#x7B26;&#x524D;&#x7559;&#x4E00;&#x4E2A;&#x7A7A;&#x683C;&#xFF09;</li>
<li>&#x4E0D;&#x8981;&#x5728;&#x5F00;&#x59CB;&#x7B26;&#x3001;&#x7ED3;&#x675F;&#x7B26;&#x6240;&#x5728;&#x884C;&#x5199;&#x6CE8;&#x91CA;</li>
<li>&#x5C3D;&#x91CF;&#x4F7F;&#x7528;&#x5355;&#x884C;&#x6CE8;&#x91CA;&#x4EE3;&#x66FF;&#x591A;&#x884C;&#x6CE8;&#x91CA;</li>
<li>&#x6CE8;&#x91CA;&#x51FD;&#x6570;&#x65F6;&#xFF0C;&#x63A8;&#x8350;&#x4F7F;&#x7528;&#x591A;&#x884C;&#x6CE8;&#x91CA;</li>
</ul>
</li>
</ul>
<pre><code class="lang-js">  <span class="hljs-comment">/*
    &#x8FD9;&#x91CC;&#x6709;&#x4E00;&#x884C;&#x6CE8;&#x91CA;
    &#x8FD9;&#x91CC;&#x6709;&#x4E00;&#x884C;&#x6CE8;&#x91CA;
    &#x8FD9;&#x91CC;&#x6709;&#x4E00;&#x884C;&#x6CE8;&#x91CA;
   */</span>
</code></pre>
<ul>
<li>&#x51FD;&#x6570;&#x6CE8;&#x91CA;<ul>
<li>&#x5176;&#x95F4;&#x6BCF;&#x4E00;&#x884C;&#x90FD;&#x4EE5; <code>*</code> &#x5F00;&#x5934;&#xFF0C;&#x4E14;&#x4E0E;&#x7B2C;&#x4E00;&#x884C;&#x7B2C;&#x4E00;&#x4E2A; <code>*</code> &#x5BF9;&#x9F50;</li>
<li>&#x6CE8;&#x91CA;&#x5185;&#x5BB9;&#x4E0E; <code>*</code> &#x95F4;&#x7559;&#x4E00;&#x4E2A;&#x7A7A;&#x683C;</li>
<li>&#x5FC5;&#x987B;&#x5305;&#x542B;&#x6807;&#x7B7E;&#x6CE8;&#x91CA;&#x3002;&#x4F8B;&#xFF1A;</li>
</ul>
</li>
</ul>
<pre><code class="lang-js"><span class="hljs-comment">/**
* &#x65B9;&#x6CD5;&#x8BF4;&#x660E;
* @method &#x65B9;&#x6CD5;&#x540D;
* @for &#x6240;&#x5C5E;&#x7C7B;&#x540D;
* @param {&#x53C2;&#x6570;&#x7C7B;&#x578B;} &#x53C2;&#x6570;&#x540D; &#x53C2;&#x6570;&#x8BF4;&#x660E;
* @return {&#x8FD4;&#x56DE;&#x503C;&#x7C7B;&#x578B;} &#x8FD4;&#x56DE;&#x503C;&#x8BF4;&#x660E;
*/</span>
</code></pre>
<h4 id="&#x6CE8;&#x91CA;&#x5E38;&#x7528;&#x6807;&#x7B7E;&#x7528;&#x6CD5;"><a name="&#x6CE8;&#x91CA;&#x5E38;&#x7528;&#x6807;&#x7B7E;&#x7528;&#x6CD5;" class="anchor-navigation-ex-anchor" href="#&#x6CE8;&#x91CA;&#x5E38;&#x7528;&#x6807;&#x7B7E;&#x7528;&#x6CD5;"><i class="fa fa-link" aria-hidden="true"></i></a>&#x6CE8;&#x91CA;&#x5E38;&#x7528;&#x6807;&#x7B7E;&#x7528;&#x6CD5;</h4>
<ul>
<li>@type {typeName}<ul>
<li><code>*</code> &#x8868;&#x793A;&#x4EFB;&#x4F55;&#x7C7B;&#x578B;</li>
<li><code>?</code> &#x8868;&#x793A;&#x53EF;&#x4EE5;&#x4E3A; <code>null</code></li>
<li><code>!</code> &#x8868;&#x793A;&#x4E0D;&#x80FD;&#x4E3A; <code>null</code></li>
<li><code>[]</code> &#x8868;&#x793A;&#x6570;&#x7EC4;</li>
</ul>
</li>
</ul>
<pre><code class="lang-js"><span class="hljs-comment">/**
* @type {number}
*/</span>
<span class="hljs-keyword">var</span> foo1;

<span class="hljs-comment">/**
* @type {*}
* @desc &#x4EFB;&#x4F55;&#x7C7B;&#x578B;
*/</span>
<span class="hljs-keyword">var</span> foo2;

<span class="hljs-comment">/**
* @type {?string}
* @desc string&#x6216;&#x8005;null
*/</span>
<span class="hljs-keyword">var</span> foo3;
</code></pre>
<ul>
<li>@param {} name - some description<ul>
<li>&#x975E;&#x5FC5;&#x4F20;&#x53C2;&#x6570;&#x9700;&#x7ED9;&#x53C2;&#x6570;&#x540D;&#x52A0;&#x4E0A; <code>[]</code></li>
<li>&#x53C2;&#x6570;&#x5982;&#x6709;&#x9ED8;&#x8BA4;&#x503C;&#x9700;&#x7528; <code>=</code> &#x8868;&#x793A;</li>
<li>&#x5982;&#x679C;&#x53C2;&#x6570;&#x662F; Object&#xFF0C;&#x53EF;&#x7EE7;&#x7EED;&#x7528; <code>@param</code> &#x5BF9;&#x5176;&#x5C5E;&#x6027;&#x8FDB;&#x884C;&#x8BE6;&#x7EC6;&#x8BF4;&#x660E;</li>
<li>&#x82E5;&#x5E72;&#x4E2A;&#x53C2;&#x6570;&#x7528; <code>...</code> &#x8868;&#x793A;</li>
</ul>
</li>
</ul>
<pre><code class="lang-js"><span class="hljs-comment">/**
 * @func
 * @desc &#x4E00;&#x4E2A;&#x5E26;&#x53C2;&#x6570;&#x7684;&#x51FD;&#x6570;
 * @param {string} a - &#x53C2;&#x6570;a
 * @param {number} b=1 - &#x53C2;&#x6570;b&#x9ED8;&#x8BA4;&#x503C;&#x4E3A;1
 * @param {string} c=1 - &#x53C2;&#x6570;c&#x6709;&#x4E24;&#x79CD;&#x652F;&#x6301;&#x7684;&#x53D6;&#x503C;  1&#x2014;&#x8868;&#x793A;x  2&#x2014;&#x8868;&#x793A;xx
 * @param {object} d - &#x53C2;&#x6570;d&#x4E3A;&#x4E00;&#x4E2A;&#x5BF9;&#x8C61;
 * @param {string} d.e - &#x53C2;&#x6570;d&#x7684;e&#x5C5E;&#x6027;
 * @param {object[]} g - &#x53C2;&#x6570;g&#x4E3A;&#x4E00;&#x4E2A;&#x5BF9;&#x8C61;&#x6570;&#x7EC4;
 * @param {string} g.h - &#x53C2;&#x6570;g&#x6570;&#x7EC4;&#x4E2D;&#x4E00;&#x9879;&#x7684;h&#x5C5E;&#x6027;
 * @param {string} [j] - &#x53C2;&#x6570;j&#x662F;&#x4E00;&#x4E2A;&#x53EF;&#x9009;&#x53C2;&#x6570;
 */</span>
 <span class="hljs-function"><span class="hljs-keyword">function</span> <span class="hljs-title">foo</span>(<span class="hljs-params">a, b, c, d, g, j</span>) </span>{}

<span class="hljs-comment">/**
 * @func
 * @desc &#x4E00;&#x4E2A;&#x5E26;&#x82E5;&#x5E72;&#x53C2;&#x6570;&#x7684;&#x51FD;&#x6570;
 * @param {...string} a - &#x53C2;&#x6570;a
 */</span>
<span class="hljs-function"><span class="hljs-keyword">function</span> <span class="hljs-title">bar</span>(<span class="hljs-params">a</span>) </span>{}
</code></pre>
<h3 id="&#x62D3;&#x5C55;&#x7BC7;"><a name="&#x62D3;&#x5C55;&#x7BC7;" class="anchor-navigation-ex-anchor" href="#&#x62D3;&#x5C55;&#x7BC7;"><i class="fa fa-link" aria-hidden="true"></i></a>1.1.5. &#x62D3;&#x5C55;&#x7BC7;</h3>
<h4 id="ie-&#x6761;&#x4EF6;&#x6CE8;&#x91CA;&#xFF08;ie5&#xFF09;"><a name="ie-&#x6761;&#x4EF6;&#x6CE8;&#x91CA;&#xFF08;ie5&#xFF09;" class="anchor-navigation-ex-anchor" href="#ie-&#x6761;&#x4EF6;&#x6CE8;&#x91CA;&#xFF08;ie5&#xFF09;"><i class="fa fa-link" aria-hidden="true"></i></a>IE &#x6761;&#x4EF6;&#x6CE8;&#x91CA;&#xFF08;IE5+&#xFF09;</h4>
<p>IE &#x6761;&#x4EF6;&#x6CE8;&#x91CA;&#x5206;&#x4E3A;&#x4EE5;&#x4E0B;&#x51E0;&#x79CD;&#x60C5;&#x51B5;&#xFF1A;</p>
<ul>
<li>&#x53EA;&#x5141;&#x8BB8; IE &#x89E3;&#x91CA;&#x6267;&#x884C;     <code>&lt;!--[if IE]&gt;&lt;![endif]--&gt;</code></li>
<li>&#x53EA;&#x5141;&#x8BB8; IE &#x7279;&#x5B9A;&#x7248;&#x672C;&#x89E3;&#x91CA;&#x6267;&#x884C;     <code>&lt;!--[if IE 7]&gt;&lt;![endif]--&gt;</code></li>
<li>&#x53EA;&#x5141;&#x8BB8;&#x975E; IE &#x7279;&#x5B9A;&#x7248;&#x672C;&#x6267;&#x884C;&#x6CE8;&#x91CA;     <code>&lt;!--[if !IE 7]&gt;&lt;![endif]--&gt;</code></li>
<li>&#x53EA;&#x5141;&#x8BB8;&#x9AD8;&#x4E8E;&#x6216;&#x4F4E;&#x4E8E; IE &#x7279;&#x5B9A;&#x7248;&#x672C;&#x6267;&#x884C;&#x6CE8;&#x91CA;     <code>&lt;!--[if gt IE 7]&gt;&lt;![endif]--&gt;</code></li>
</ul>
<pre><code class="lang-xml"> <span class="hljs-tag">&lt;<span class="hljs-name">head</span>&gt;</span>
      <span class="hljs-tag">&lt;<span class="hljs-name">title</span>&gt;</span>IE &#x6761;&#x4EF6;&#x6CE8;&#x91CA;<span class="hljs-tag">&lt;/<span class="hljs-name">title</span>&gt;</span>

      <span class="hljs-comment">&lt;!-- &#x662F; IE &#x65F6; --&gt;</span>
    <span class="hljs-comment">&lt;!--[if IE]&gt; 
        &lt;link href=&quot;style.css&quot; rel=&quot;stylesheet&quot; type=&quot;text/css&quot; /&gt;
    &lt;![endif]--&gt;</span>

    <span class="hljs-comment">&lt;!-- &#x662F; IE 7 &#x65F6; --&gt;</span>
          <span class="hljs-comment">&lt;!--[if IE 7]&gt;
       &lt;link href=&quot;style.css&quot; rel=&quot;stylesheet&quot; type=&quot;text/css&quot; /&gt;
    &lt;![endif]--&gt;</span>

    <span class="hljs-comment">&lt;!-- &#x4E0D;&#x662F; IE 7 &#x65F6; --&gt;</span>
      <span class="hljs-comment">&lt;!--[if !IE 7]&gt;
        &lt;link href=&quot;style.css&quot; rel=&quot;stylesheet&quot; type=&quot;text/css&quot; /&gt;
    &lt;![endif]--&gt;</span>

      <span class="hljs-comment">&lt;!-- &#x5927;&#x4E8E; IE 7 &#x65F6; --&gt;</span>
      <span class="hljs-comment">&lt;!--[if gt IE 7]&gt;
       &lt;link href=&quot;style.css&quot; rel=&quot;stylesheet&quot; type=&quot;text/css&quot; /&gt;
    &lt;![endif]--&gt;</span>

      <span class="hljs-comment">&lt;!-- &#x5C0F;&#x4E8E; IE 7 &#x65F6; --&gt;</span>
       <span class="hljs-comment">&lt;!--[if lt IE 7]&gt;
       &lt;link href=&quot;style.css&quot; rel=&quot;stylesheet&quot; type=&quot;text/css&quot; /&gt;
    &lt;![endif]--&gt;</span>
<span class="hljs-tag">&lt;/<span class="hljs-name">head</span>&gt;</span>
</code></pre>
<h4 id="&#xFF08;&#x4E95;&#x53F7;&#xFF09;&#x6CE8;&#x91CA;-&#x548C;--&#xFF08;&#x4E09;&#x5F15;&#x53F7;&#xFF09;&#x6CE8;&#x91CA;"><a name="&#xFF08;&#x4E95;&#x53F7;&#xFF09;&#x6CE8;&#x91CA;-&#x548C;--&#xFF08;&#x4E09;&#x5F15;&#x53F7;&#xFF09;&#x6CE8;&#x91CA;" class="anchor-navigation-ex-anchor" href="#&#xFF08;&#x4E95;&#x53F7;&#xFF09;&#x6CE8;&#x91CA;-&#x548C;--&#xFF08;&#x4E09;&#x5F15;&#x53F7;&#xFF09;&#x6CE8;&#x91CA;"><i class="fa fa-link" aria-hidden="true"></i></a># &#xFF08;&#x4E95;&#x53F7;&#xFF09;&#x6CE8;&#x91CA; &#x548C; &apos;&apos;&apos; &#xFF08;&#x4E09;&#x5F15;&#x53F7;&#xFF09;&#x6CE8;&#x91CA;</h4>
<ul>
<li><code>#</code> &#x4E00;&#x822C;&#x51FA;&#x73B0;&#x5728;&#x5404;&#x79CD;&#x811A;&#x672C;&#x914D;&#x7F6E;&#x6587;&#x4EF6;&#x4E2D;&#xFF0C;&#x7528;&#x6CD5;&#x4E0E; JS &#x5355;&#x884C;&#x6CE8;&#x91CA; <code>//</code> &#x57FA;&#x672C;&#x76F8;&#x540C;&#x3002;Python &#x4E2D;&#x4E5F;&#x5E38;&#x5E38;&#x7528;&#x5230;</li>
<li><code>&apos;&apos;&apos;</code> &#x662F; Python &#x4E2D;&#x7684;&#x591A;&#x884C;&#x6CE8;&#x91CA;&#x8BED;&#x6CD5;&#xFF0C;&#x7528;&#x4E24;&#x4E2A; <code>&apos;&apos;&apos;</code> &#x5305;&#x542B;&#x88AB;&#x6CE8;&#x91CA;&#x7684;&#x6BB5;&#x843D;</li>
</ul>
<pre><code class="lang-python"><span class="hljs-comment"># python &#x7684;&#x5355;&#x884C;&#x6CE8;&#x91CA;&#x4E00;</span>
    print(<span class="hljs-string">&quot;I could have code like this.&quot;</span>) <span class="hljs-comment"># python &#x7684;&#x5355;&#x884C;&#x6CE8;&#x91CA;&#x4E8C;</span>

<span class="hljs-comment"># print(&quot;This won&apos;t run.&quot;) # &#x88AB;&#x6CE8;&#x91CA;&#x7684;&#x4EE3;&#x7801;</span>

<span class="hljs-string">&apos;&apos;&apos;
    &#x88AB;&#x4E09;&#x5F15;&#x53F7;&#x5305;&#x88F9;&#x7684;&#x6BB5;&#x843D;
    &#x53EF;&#x4EE5;&#x968F;&#x610F;&#x6298;&#x884C;
    &#x4E5F;&#x53EF;&#x4EE5;&#x6CE8;&#x91CA;&#x4EE3;&#x7801;
    print(&quot;This won&apos;t run.&quot;)
&apos;&apos;&apos;</span>
</code></pre>
<h4 id="&#x6CE8;&#x91CA;-&#x88AB;&#x6267;&#x884C;-&#x4E86;&#xFF1F;"><a name="&#x6CE8;&#x91CA;-&#x88AB;&#x6267;&#x884C;-&#x4E86;&#xFF1F;" class="anchor-navigation-ex-anchor" href="#&#x6CE8;&#x91CA;-&#x88AB;&#x6267;&#x884C;-&#x4E86;&#xFF1F;"><i class="fa fa-link" aria-hidden="true"></i></a>&#x6CE8;&#x91CA; &#x201C;&#x88AB;&#x6267;&#x884C;&#x201D; &#x4E86;&#xFF1F;</h4>
<p>&#x4F17;&#x6240;&#x5468;&#x77E5;&#xFF0C;&#x6CE8;&#x91CA;&#x7684;&#x4EE3;&#x7801;&#x662F;&#x4E0D;&#x4F1A;&#x88AB;&#x6267;&#x884C;&#x7684;&#x3002;&#x4F46;&#x662F;&#x5C0F;&#x7F16;&#x5728;&#x67E5;&#x8D44;&#x6599;&#x65F6;&#x770B;&#x5230;&#x4E86;&#x4E00;&#x6BB5;&#x6BD4;&#x8F83;&#x6709;&#x610F;&#x601D;&#x7684;&#x4EE3;&#x7801;&#xFF0C; Java &#x4E2D;&#x7684;&#x4E00;&#x884C;&#x6CE8;&#x91CA;&#x201C;&#x88AB;&#x6267;&#x884C;&#x201D;&#x4E86;&#xFF1F;</p>
<pre><code class="lang-java"><span class="hljs-keyword">public</span> <span class="hljs-class"><span class="hljs-keyword">class</span> <span class="hljs-title">Test</span> </span>{
    <span class="hljs-function"><span class="hljs-keyword">public</span> <span class="hljs-keyword">static</span> <span class="hljs-keyword">void</span> <span class="hljs-title">main</span><span class="hljs-params">(String[] args)</span> </span>{
        String name = <span class="hljs-string">&quot;&#x8D75;&#x5927;&quot;</span>;
        <span class="hljs-comment">// \u000dname=&quot;&#x94B1;&#x4E8C;&quot;;</span>
        System.out.println(name);
    }
}
</code></pre>
<p>&#x8FD9;&#x6BB5;&#x4EE3;&#x7801;&#x6267;&#x884C;&#x540E;&#x7684;&#x7ED3;&#x679C;&#x4E3A;<code>&#x94B1;&#x4E8C;</code>&#xFF0C;&#x4E5F;&#x5C31;&#x662F;&#x8BF4;&#x5728;&#x8FD9;&#x6BB5;&#x4EE3;&#x7801;&#x4E2D;&#xFF0C;&#x201C;&#x88AB;&#x6CE8;&#x91CA;&#x201D;&#x7684;&#x90A3;&#x884C;&#x4EE3;&#x7801;&#x751F;&#x6548;&#x4E86;&#xFF01;</p>
<p>&#x8FD9;&#x6BB5;&#x4EE3;&#x7801;&#x7684;&#x95EE;&#x9898;&#x51FA;&#x5728; <code>\u000d</code> &#x8FD9;&#x4E32;&#x7279;&#x6B8A;&#x5B57;&#x7B26;&#x4E0A;&#x3002;<code>\u000d</code> &#x662F;&#x4E00;&#x4E32; Unicode &#x5B57;&#x7B26;&#xFF0C;&#x4EE3;&#x8868;&#x6362;&#x884C;&#x7B26;&#x3002;Java &#x7F16;&#x8BD1;&#x5668;&#x4E0D;&#x4EC5;&#x4F1A;&#x7F16;&#x8BD1;&#x4EE3;&#x7801;&#xFF0C;&#x8FD8;&#x4F1A;&#x89E3;&#x6790; Unicode &#x5B57;&#x7B26;&#x3002;&#x5728;&#x4E0A;&#x9762;&#x8FD9;&#x6BB5;&#x4EE3;&#x7801;&#x628A; <code>\u000d</code> &#x7ED9;&#x89E3;&#x6790;&#x4E86;&#xFF0C;&#x540E;&#x9762;&#x7684;&#x4EE3;&#x7801;&#x5C31;&#x5230;&#x4E86;&#x4E0B;&#x9762;&#x4E00;&#x884C;&#xFF0C;&#x8D85;&#x51FA;&#x4E86;&#x88AB;&#x6CE8;&#x91CA;&#x7684;&#x8303;&#x56F4;&#xFF08;&#x5355;&#x884C;&#x6CE8;&#x91CA;&#x7684;&#x6CE8;&#x91CA;&#x8303;&#x56F4;&#x4EC5;&#x5728;&#x5F53;&#x524D;&#x884C;&#xFF09;&#xFF0C;&#x6240;&#x4EE5;&#x6267;&#x884C;&#x7ED3;&#x679C;&#x4E3A; <code>&#x94B1;&#x4E8C;</code> &#x800C;&#x975E; <code>&#x8D75;&#x5927;</code>&#x3002;&#xFF08;&#x5982;&#x4E0B;&#xFF09;</p>
<pre><code class="lang-java"><span class="hljs-keyword">public</span> <span class="hljs-class"><span class="hljs-keyword">class</span> <span class="hljs-title">Test</span> </span>{
    <span class="hljs-function"><span class="hljs-keyword">public</span> <span class="hljs-keyword">static</span> <span class="hljs-keyword">void</span> <span class="hljs-title">main</span><span class="hljs-params">(String[] args)</span> </span>{
        String name = <span class="hljs-string">&quot;&#x8D75;&#x5927;&quot;</span>;
        <span class="hljs-comment">//</span>
        name=<span class="hljs-string">&quot;&#x94B1;&#x4E8C;&quot;</span>;
        System.out.println(name);
    }
}
</code></pre>
<p>&#x6240;&#x4EE5;&#x672C;&#x8D28;&#x4E0A;&#x5728;&#x4EE3;&#x7801;&#x6267;&#x884C;&#x7684;&#x65F6;&#x5019; <code>name=&quot;&#x94B1;&#x4E8C;&quot;</code> &#x5E76;&#x6CA1;&#x6709;&#x88AB;&#x6CE8;&#x91CA;&#xFF0C;&#x800C;&#x662F;&#x88AB;&#x6362;&#x4E86;&#x884C;&#xFF08;&#x5947;&#x602A;&#x7684;&#x77E5;&#x8BC6;&#x589E;&#x52A0;&#x4E86;&#xFF09;&#x3002; &#x6240;&#x4EE5;&#x5207;&#x8BB0;&#xFF0C;&#x6CE8;&#x91CA;&#x786E;&#x5B9E;&#x662F;&#x4E0D;&#x4F1A;&#x88AB;&#x6267;&#x884C;&#x7684;&#x54E6;&#xFF01;</p>
<h3 id="&#x6CE8;&#x91CA;&#x76F8;&#x5173;&#x63D2;&#x4EF6;"><a name="&#x6CE8;&#x91CA;&#x76F8;&#x5173;&#x63D2;&#x4EF6;" class="anchor-navigation-ex-anchor" href="#&#x6CE8;&#x91CA;&#x76F8;&#x5173;&#x63D2;&#x4EF6;"><i class="fa fa-link" aria-hidden="true"></i></a>1.1.6. &#x6CE8;&#x91CA;&#x76F8;&#x5173;&#x63D2;&#x4EF6;</h3>
<p>&#x5728;&#x8FD9;&#x91CC;&#x63A8;&#x8350;&#x51E0;&#x4E2A;&#x4E2A;&#x4EBA;&#x8BA4;&#x4E3A;&#x6BD4;&#x8F83;&#x597D;&#x7528;&#x7684;&#x6CE8;&#x91CA;&#x76F8;&#x5173;&#x7684; Vscode &#x63D2;&#x4EF6;&#xFF0C;&#x53EF;&#x5728; <code>setting.json</code> &#x6587;&#x4EF6;&#x4E0B;&#x81EA;&#x5B9A;&#x4E49;&#x8BBE;&#x7F6E;&#xFF08;&#x53EF;&#x901A;&#x8FC7; &apos;&#x6587;&#x4EF6;&#x2014;&#x9996;&#x9009;&#x9879;&#x2014;&#x8BBE;&#x7F6E;&apos;&#xFF0C;&#x6253;&#x5F00; Vscode &#x6587;&#x4EF6; <code>settings.json</code> &#xFF09;</p>
<ul>
<li><a href="https://marketplace.visualstudio.com/items?itemName=OBKoro1.korofileheader" target="_blank">koroFileHeader</a> &#x5728;vscode&#x4E2D;&#x7528;&#x4E8E;&#x751F;&#x6210;&#x6587;&#x4EF6;&#x5934;&#x90E8;&#x6CE8;&#x91CA;&#x548C;&#x51FD;&#x6570;&#x6CE8;&#x91CA;&#x7684;&#x63D2;&#x4EF6;</li>
<li><p>&#x6587;&#x4EF6;&#x5934;&#x90E8;&#x6DFB;&#x52A0;&#x6CE8;&#x91CA;</p>
<ul>
<li>&#x5728;&#x6587;&#x4EF6;&#x5F00;&#x5934;&#x6DFB;&#x52A0;&#x6CE8;&#x91CA;&#xFF0C;&#x8BB0;&#x5F55;&#x6587;&#x4EF6;&#x4FE1;&#x606F;/&#x6587;&#x4EF6;&#x7684;&#x4F20;&#x53C2;/&#x51FA;&#x53C2;&#x7B49;</li>
<li>&#x652F;&#x6301;&#x7528;&#x6237;&#x9AD8;&#x5EA6;&#x81EA;&#x5B9A;&#x4E49;&#x6CE8;&#x91CA;&#x9009;&#x9879;, &#x9002;&#x914D;&#x5404;&#x79CD;&#x9700;&#x6C42;&#x548C;&#x6CE8;&#x91CA;&#x3002;</li>
<li>&#x4FDD;&#x5B58;&#x6587;&#x4EF6;&#x7684;&#x65F6;&#x5019;&#xFF0C;&#x81EA;&#x52A8;&#x66F4;&#x65B0;&#x6700;&#x540E;&#x7684;&#x7F16;&#x8F91;&#x65F6;&#x95F4;&#x548C;&#x7F16;&#x8F91;&#x4EBA;</li>
<li>&#x5FEB;&#x6377;&#x952E;&#xFF1A;<code>window</code>&#xFF1A;<code>ctrl+alt+i</code>&#xFF0C;<code>mac</code>&#xFF1A;<code>ctrl+cmd+i</code>&#xFF0C;<code>linux</code>&#xFF1A;<code>ctrl+meta+i</code></li>
</ul>
</li>
<li><p>&#x5728;&#x5149;&#x6807;&#x5904;&#x6DFB;&#x52A0;&#x51FD;&#x6570;&#x6CE8;&#x91CA;</p>
<ul>
<li>&#x5728;&#x5149;&#x6807;&#x5904;&#x81EA;&#x52A8;&#x751F;&#x6210;&#x4E00;&#x4E2A;&#x6CE8;&#x91CA;&#x6A21;&#x677F;</li>
<li>&#x652F;&#x6301;&#x7528;&#x6237;&#x9AD8;&#x5EA6;&#x81EA;&#x5B9A;&#x4E49;&#x6CE8;&#x91CA;&#x9009;&#x9879;</li>
<li>&#x5FEB;&#x6377;&#x952E;&#xFF1A;<code>window</code>&#xFF1A;<code>ctrl+alt+t</code>&#xFF0C;<code>mac</code>&#xFF1A;<code>ctrl+cmd+t</code>&#xFF0C;<code>linux</code>&#xFF1A;<code>ctrl+meta+t</code></li>
<li>&#x5FEB;&#x6377;&#x952E;&#x4E0D;&#x53EF;&#x7528;&#x5F88;&#x53EF;&#x80FD;&#x662F;&#x88AB;&#x5360;&#x7528;&#x4E86;&#xFF0C;<a href="https://github.com/OBKoro1/koro1FileHeader/issues/5" target="_blank">&#x53C2;&#x8003;&#x8FD9;&#x91CC;</a></li>
<li>&#x53EF;&#x81EA;&#x5B9A;&#x4E49;&#x9ED8;&#x8BA4;&#x53C2;&#x6570;</li>
</ul>
</li>
<li><p>Better Comments &#x901A;&#x8FC7;&#x4F7F;&#x7528;&#x8B66;&#x62A5;&#xFF0C;&#x4FE1;&#x606F;&#xFF0C;TODO &#x7B49;&#x8FDB;&#x884C;&#x6CE8;&#x91CA;&#x6765;&#x6539;&#x5584;&#x4EE3;&#x7801;&#x6CE8;&#x91CA;&#x3002;&#x4F7F;&#x7528;&#x6B64;&#x6269;&#x5C55;&#xFF0C;&#x60A8;&#x5C06;&#x80FD;&#x591F;&#x5C06;&#x6CE8;&#x91CA;&#x5206;&#x7C7B;&#x4E3A;&#xFF1A;</p>
<ul>
<li>&#x5FEB;&#x8BAF;</li>
<li>&#x67E5;&#x8BE2;</li>
<li>&#x5F85;&#x529E;&#x4E8B;&#x9879;</li>
<li>&#x5F3A;&#x8C03;</li>
<li>&#x6CE8;&#x91CA;&#x6389;&#x7684;&#x4EE3;&#x7801;&#x4E5F;&#x53EF;&#x4EE5;&#x8BBE;&#x7F6E;&#x6837;&#x5F0F;&#xFF0C;&#x4EE5;&#x4F7F;&#x4EE3;&#x7801;&#x4E0D;&#x5E94;&#x8BE5;&#x5B58;&#x5728;</li>
<li>&#x53EF;&#x81EA;&#x5B9A;&#x4E49;&#x6307;&#x5B9A;&#x5176;&#x4ED6;&#x6240;&#x9700;&#x7684;&#x6CE8;&#x91CA;&#x6837;&#x5F0F;</li>
</ul>
</li>
<li><p>TODO Highlight &#x7A81;&#x51FA;&#x663E;&#x793A;TODO&#xFF0C;FIXME&#x548C;&#x4EFB;&#x4F55;&#x5173;&#x952E;&#x5B57;</p>
<ul>
<li>&#x9AD8;&#x4EAE;&#x5185;&#x7F6E;&#x5173;&#x952E;&#x5B57;&#xFF0C;&#x53EF;&#x901A;&#x8FC7;&#x81EA;&#x5B9A;&#x4E49;&#x8BBE;&#x7F6E;&#x8986;&#x76D6;&#x5916;&#x89C2;</li>
<li>&#x4E5F;&#x53EF;&#x81EA;&#x5B9A;&#x4E49;&#x5173;&#x952E;&#x5B57;</li>
</ul>
</li>
</ul>
<pre><code class="lang-js"><span class="hljs-comment">// TODO &#x672A;&#x5B8C;&#x6210;</span>
<span class="hljs-comment">// FIXME &#x5F85;&#x4FEE;&#x590D;</span>
<span class="hljs-comment">// XXX &#x5B9E;&#x73B0;&#x65B9;&#x6CD5;&#x5F85;&#x786E;&#x8BA4;</span>
<span class="hljs-comment">// NOTE &#x4EE3;&#x7801;&#x529F;&#x80FD;&#x8BF4;&#x660E;</span>
<span class="hljs-comment">// HACK &#x6B64;&#x5904;&#x5199;&#x6CD5;&#x6709;&#x5F85;&#x4F18;&#x5316;</span>
<span class="hljs-comment">// BUG &#x6B64;&#x5904;&#x6709; bug~</span>
</code></pre>
<h3 id="&#x7528;&#x4E8B;&#x5B9E;&#x8BF4;&#x8BDD;"><a name="&#x7528;&#x4E8B;&#x5B9E;&#x8BF4;&#x8BDD;" class="anchor-navigation-ex-anchor" href="#&#x7528;&#x4E8B;&#x5B9E;&#x8BF4;&#x8BDD;"><i class="fa fa-link" aria-hidden="true"></i></a>1.1.7. &#x7528;&#x4E8B;&#x5B9E;&#x8BF4;&#x8BDD;</h3>
<p>&#x53E3;&#x8BF4;&#x65E0;&#x51ED;&#xFF0C;&#x773C;&#x89C1;&#x4E3A;&#x5B9E;&#x3002;&#x4E0B;&#x9762;&#x6211;&#x4EEC;&#x770B;&#x4E0B;&#x5B9E;&#x9645;&#x5F00;&#x53D1;&#x4E2D;&#x7684;&#x5177;&#x4F53;&#x60C5;&#x51B5;&#xFF1A;</p>
<ul>
<li>&#x6CA1;&#x6709;&#x6CE8;&#x91CA;</li>
</ul>
<pre><code class="lang-js"><span class="hljs-keyword">const</span> noWarehousetemIds = beSelectSkucontainer.reduce(<span class="hljs-function">(<span class="hljs-params">arr, itemId</span>) =&gt;</span> {
    <span class="hljs-keyword">const</span> res = <span class="hljs-built_in">Object</span>.keys(selectRowskey[itemId]).every(<span class="hljs-function">(<span class="hljs-params">skuId</span>) =&gt;</span> {
      <span class="hljs-keyword">const</span> sku = selectRowskey[itemId][skuId];
      <span class="hljs-keyword">return</span> !!sku.warehouseCode || lodashGet(warehouses, <span class="hljs-string">&apos;[0].code&apos;</span>);
    });
    <span class="hljs-keyword">if</span> (!res) {
      arr.push(itemId);
    }
    <span class="hljs-keyword">return</span> arr;
  }, []);
  <span class="hljs-keyword">if</span> (noWarehousetemIds.length &gt; <span class="hljs-number">0</span> || noStockItemIds.length &gt; <span class="hljs-number">0</span>) {
    <span class="hljs-keyword">const</span> itemIds = <span class="hljs-built_in">Array</span>.from(<span class="hljs-keyword">new</span> <span class="hljs-built_in">Set</span>([...noWarehousetemIds, ...noStockItemIds]));
    <span class="hljs-keyword">const</span> itemNames = itemIds.map(<span class="hljs-function"><span class="hljs-params">i</span> =&gt;</span> <span class="hljs-keyword">this</span>.itemNameMap[i].itemName);
    <span class="hljs-keyword">return</span> Modal.warning({
      <span class="hljs-attr">title</span>: <span class="hljs-string">&apos;&#x9519;&#x8BEF;&#x63D0;&#x793A;&apos;</span>,
      <span class="hljs-attr">content</span>: <span class="hljs-string">`&#x201C;<span class="hljs-subst">${itemNames.join(<span class="hljs-string">&apos;,&apos;</span>)}</span>&#x201D;&#x5E93;&#x5B58;&#x4FE1;&#x606F;&#x672A;&#x5B8C;&#x5584;&#xFF0C;&#x8BF7;&#x5B8C;&#x5584;&#x5E93;&#x5B58;&#x4FE1;&#x606F;`</span>,
    });
  }
</code></pre>
<ul>
<li>&#x4E00;&#x822C;&#x822C;&#x7684;&#x6CE8;&#x91CA;</li>
</ul>
<pre><code class="lang-js"><span class="hljs-comment">// &#x904D;&#x5386;&#x5F53;&#x524D;&#x6240;&#x6709;&#x9009;&#x4E2D;&#x7684;sku&#xFF0C;&#x67E5;&#x627E;&#x51FA;&#x6CA1;&#x6709;&#x5E93;&#x5B58;&#x7684;itemId</span>
<span class="hljs-keyword">const</span> noStockItemIds = beSelectSkucontainer.reduce(<span class="hljs-function">(<span class="hljs-params">arr, itemId</span>) =&gt;</span> {
  <span class="hljs-keyword">const</span> res = <span class="hljs-built_in">Object</span>.keys(selectRowskey[itemId]).every(<span class="hljs-function">(<span class="hljs-params">skuId</span>) =&gt;</span> {
    <span class="hljs-keyword">const</span> sku = selectRowskey[itemId][skuId];
    <span class="hljs-keyword">return</span> !!sku.stockQuantity;
  });
  <span class="hljs-keyword">if</span> (!res) {
    arr.push(itemId);
  }
  <span class="hljs-keyword">return</span> arr;
}, []);
<span class="hljs-comment">// &#x6709;&#x4E00;&#x6761;sku&#x7684;&#x5E93;&#x5B58;&#x4E3A;&#x7A7A;&#x65F6;&#x8FDB;&#x5165;&#x6821;&#x9A8C;</span>
<span class="hljs-keyword">if</span> (noStockItemIds.length &gt; <span class="hljs-number">0</span>) {
  <span class="hljs-keyword">const</span> itemNames = itemIds.map(<span class="hljs-function"><span class="hljs-params">i</span> =&gt;</span> <span class="hljs-keyword">this</span>.itemNameMap[i].itemName);
  <span class="hljs-keyword">return</span> Modal.warning({
    <span class="hljs-attr">title</span>: <span class="hljs-string">&apos;&#x9519;&#x8BEF;&#x63D0;&#x793A;&apos;</span>,
    <span class="hljs-attr">content</span>: <span class="hljs-string">`&#x201C;<span class="hljs-subst">${itemNames.join(<span class="hljs-string">&apos;,&apos;</span>)}</span>&#x201D;&#x5E93;&#x5B58;&#x4FE1;&#x606F;&#x672A;&#x5B8C;&#x5584;&#xFF0C;&#x8BF7;&#x5B8C;&#x5584;&#x5E93;&#x5B58;&#x4FE1;&#x606F;`</span>,
  });
}
</code></pre>
<ul>
<li>&#x66F4;&#x597D;&#x7684;&#x6CE8;&#x91CA;</li>
</ul>
<pre><code class="lang-js"><span class="hljs-comment">// &#x904D;&#x5386;&#x5F53;&#x524D;&#x6240;&#x6709;&#x9009;&#x4E2D;&#x7684;sku&#xFF0C;&#x67E5;&#x627E;&#x51FA;&#x6CA1;&#x6709;&#x5E93;&#x5B58;&#x7684;itemId</span>
<span class="hljs-keyword">const</span> noStockItemIds = beSelectSkucontainer.reduce(<span class="hljs-function">(<span class="hljs-params">arr, itemId</span>) =&gt;</span> {
    <span class="hljs-comment">// selectRowskey&#x662F;&#x4E00;&#x4E2A;&#x5BF9;&#x8C61;&#xFF0C;&#x4EE5;itemId&#x4E3A;key&#xFF0C;sku&#x5BF9;&#x8C61;&#x4F5C;&#x4E3A;value&#xFF0C;sku&#x5BF9;&#x8C61;&#x4EE5;skuId&#x4F5C;&#x4E3A;key&#xFF0C;sku&#x4F5C;&#x4E3A;value&#xFF0C;&#x53EA;&#x6709;selectRowskey&#x4E0B;&#x6240;&#x6709;itemId&#x4E0B;&#x7684;sku&#x90FD;&#x6709;&#x5E93;&#x5B58;&#x624D;&#x7B97;&#x6821;&#x9A8C;&#x901A;&#x8FC7;</span>
    <span class="hljs-comment">/*
        &#x6570;&#x636E;&#x683C;&#x5F0F;:
        selectRowskey: {
          12345678: { // itemId
              123456: { // skuId
              name: &apos;sku&apos;,
              }
          }
        }
      */</span>
    <span class="hljs-keyword">const</span> res = <span class="hljs-built_in">Object</span>.keys(selectRowskey[itemId]).every(<span class="hljs-function">(<span class="hljs-params">skuId</span>) =&gt;</span> {
        <span class="hljs-keyword">const</span> sku = selectRowskey[itemId][skuId];
        <span class="hljs-keyword">return</span> !!sku.stockQuantity;
    });
    <span class="hljs-comment">// &#x53EA;&#x8981;&#x6709;&#x4E00;&#x6761;sku&#x6CA1;&#x6709;&#x5E93;&#x5B58;&#x65F6;&#xFF0C;&#x5C31;&#x585E;&#x5230;arr&#x4E2D;&#xFF0C;&#x8FD4;&#x56DE;&#x7ED9;noStockItemIds&#x6570;&#x7EC4;</span>
    <span class="hljs-keyword">if</span> (!res) {
        arr.push(itemId);
    }
    <span class="hljs-keyword">return</span> arr;
}, []);
<span class="hljs-comment">// &#x6709;&#x4E00;&#x6761;sku&#x7684;&#x5E93;&#x5B58;&#x4E3A;&#x7A7A;&#x65F6;&#x8FDB;&#x5165;&#x6821;&#x9A8C;</span>
<span class="hljs-keyword">if</span> (noStockItemIds.length &gt; <span class="hljs-number">0</span>) {
    <span class="hljs-comment">// &#x6839;&#x636E;id&#x67E5;&#x627E;&#x5546;&#x54C1;&#x540D;&#x79F0;</span>
    <span class="hljs-keyword">const</span> itemNames = itemIds.map(<span class="hljs-function"><span class="hljs-params">i</span> =&gt;</span> <span class="hljs-keyword">this</span>.itemNameMap[i].itemName);
    Modal.warning({
        <span class="hljs-attr">title</span>: <span class="hljs-string">&apos;&#x9519;&#x8BEF;&#x63D0;&#x793A;&apos;</span>,
        <span class="hljs-attr">content</span>: <span class="hljs-string">`&#x201C;<span class="hljs-subst">${itemNames.join(<span class="hljs-string">&apos;,&apos;</span>)}</span>&#x201D;&#x5E93;&#x5B58;&#x4FE1;&#x606F;&#x672A;&#x5B8C;&#x5584;&#xFF0C;&#x8BF7;&#x5B8C;&#x5584;&#x5E93;&#x5B58;&#x4FE1;&#x606F;`</span>,
    });
}
</code></pre>
<p>&#x770B;&#x5230;&#x4E0A;&#x9762;&#x8FD9;&#x6BB5;&#x4EE3;&#x7801;&#x53EF;&#x4EE5;&#x5F88;&#x660E;&#x663E;&#x7684;&#x4F53;&#x4F1A;&#x5230;&#x6709;&#x6CA1;&#x6709;&#x6CE8;&#x91CA;&#x4EE5;&#x53CA;&#x6CE8;&#x91CA;&#x5199;&#x7684;&#x6E05;&#x4E0D;&#x6E05;&#x695A;&#x7684;&#x91CD;&#x8981;&#x6027;&#x3002;&#x82E5;&#x662F;&#x5199;&#x4E86;&#x6CE8;&#x91CA;&#x4F46;&#x4ECD;&#x7136;&#x770B;&#x4E0D;&#x61C2;&#xFF0C;&#x90A3;&#x8FD8;&#x4E0D;&#x5982;&#x4E0D;&#x5199;&#x3002;</p>
<p>&#x6240;&#x4EE5;&#x6CE8;&#x91CA;&#x4E5F;&#x4E0D;&#x662F;&#x968F;&#x4FBF;&#x5199;&#x4E00;&#x5199;&#x5C31;&#x53EF;&#x4EE5;&#x7684;&#xFF0C;&#x8981;&#x63CF;&#x8FF0;&#x67D0;&#x6BB5;&#x4EE3;&#x7801;&#x7684;&#x529F;&#x80FD;&#xFF0C;&#x6CE8;&#x660E;&#x903B;&#x8F91;&#xFF0C;&#x8BA9;&#x5F00;&#x53D1;&#x8005;&#x53EF;&#x4EE5;&#x201D;&#x65E0;&#x8111;&#x201C;&#x6D4F;&#x89C8;&#x3002;</p>
<p>&#x4E4B;&#x524D;&#x5728;&#x5DE5;&#x4F5C;&#x7FA4;&#x4E2D;&#x770B;&#x5230;&#x6709;&#x4EBA;&#x53D1;&#x8FC7;&#x8FD9;&#x6837;&#x4E00;&#x5F20;&#x56FE;&#xFF08;&#x5982;&#x4E0B;&#x56FE;&#xFF09;&#xFF0C;&#x4E2A;&#x4EBA;&#x8BA4;&#x4E3A;&#x662F;&#x4E00;&#x4E2A;&#x5F88;&#x597D;&#x7684;&#x4EE3;&#x7801;&#x6CE8;&#x91CA;&#x7684;&#x8303;&#x4F8B;&#xFF1A;</p>
<p><img src="https://gitee.com/htzyl/img_bed/raw/master/202105/20210519_200236562_0.png" alt="1"></p>
<h3 id="&#x7ED3;&#x8BED;"><a name="&#x7ED3;&#x8BED;" class="anchor-navigation-ex-anchor" href="#&#x7ED3;&#x8BED;"><i class="fa fa-link" aria-hidden="true"></i></a>1.1.8. &#x7ED3;&#x8BED;</h3>
<p>&#x770B;&#x5230;&#x8FD9;&#x91CC;&#xFF0C;&#x5BF9;&#x4E8E;&#x6CE8;&#x91CA;&#x7684;&#x91CD;&#x8981;&#x6027;&#x5404;&#x4F4D;&#x5DF2;&#x7ECF;&#x6709;&#x81EA;&#x5DF1;&#x7684;&#x8BA4;&#x77E5;&#x3002;&#x8FD8;&#x6709;&#x51E0;&#x70B9;&#x662F;&#x6211;&#x4EEC;&#x5199;&#x6CE8;&#x91CA;&#x65F6;&#x9700;&#x8981;&#x6CE8;&#x610F;&#x7684;&#xFF1A;</p>
<ul>
<li><p>&#x6CE8;&#x91CA;&#x5185;&#x5BB9;&#x8981;&#x7B80;&#x6D01;&#x3001;&#x6E05;&#x695A;&#x660E;&#x4E86;&#x3002;&#x6CE8;&#x91CA;&#x7B80;&#x8FF0;&#x529F;&#x80FD;&#x6216;&#x5B9E;&#x73B0;&#x903B;&#x8F91;&#x5373;&#x53EF;&#xFF0C;&#x65E0;&#x9700;&#x6BCF;&#x884C;&#x4EE3;&#x7801;&#x90FD;&#x6DFB;&#x52A0;&#x6CE8;&#x91CA;</p>
</li>
<li><p>&#x4EE3;&#x7801;&#x82E5;&#x6709;&#x4FEE;&#x6539;&#xFF0C;&#x5207;&#x8BB0;&#x540C;&#x6B65;&#x4FEE;&#x6539;&#x5BF9;&#x5E94;&#x7684;&#x6CE8;&#x91CA;&#x3002;&#x4E0D;&#x8981;&#x51FA;&#x73B0;&#x8FC7;&#x671F;&#x7684;&#x6CE8;&#x91CA;&#xFF0C;&#x5426;&#x5219;&#x4F1A;&#x8D77;&#x5230;&#x53CD;&#x4F5C;&#x7528;</p>
<p>&#x6709;&#x4EFB;&#x4F55;&#x610F;&#x89C1;&#x6B22;&#x8FCE;&#x4E0B;&#x65B9;&#x8BC4;&#x8BBA;&#x533A;&#x7559;&#x8A00;&#x8BA8;&#x8BBA;~ </p>
</li>
</ul>
<footer class="page-footer"><span class="copyright">Copyright &#xA9; zhengyuliang all right reserved&#xFF0C;powered by Gitbook</span><span class="footer-modification">&#x8BE5;&#x6587;&#x4EF6;&#x7F16;&#x5199;&#x65F6;&#x95F4;&#xFF1A;
2021-05-19 20:06:41
</span></footer></body></html>
                                
                                </section>
                            
    </div>
    <div class="search-results">
        <div class="has-results">
            
            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
            <ul class="search-results-list"></ul>
            
        </div>
        <div class="no-results">
            
            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
            
        </div>
    </div>
</div>

                        </div>
                    </div>
                
            </div>

            
                
                <a href="灵活运用JS开发技巧.html" class="navigation navigation-prev " aria-label="Previous page: 灵活运用JS开发技巧">
                    <i class="fa fa-angle-left"></i>
                </a>
                
                
                <a href="编写高质量可维护的代码：优化逻辑判断.html" class="navigation navigation-next " aria-label="Next page: 编写高质量可维护的代码：优化逻辑判断">
                    <i class="fa fa-angle-right"></i>
                </a>
                
            
        
    </div>

    <script>
        var gitbook = gitbook || [];
        gitbook.push(function() {
            gitbook.page.hasChanged({"page":{"title":"编写高质量可维护的代码：一目了然的注释","level":"4.19","depth":1,"next":{"title":"编写高质量可维护的代码：优化逻辑判断","level":"4.20","depth":1,"path":"javaScript/编写高质量可维护的代码：优化逻辑判断.md","ref":"javaScript/编写高质量可维护的代码：优化逻辑判断.md","articles":[]},"previous":{"title":"灵活运用JS开发技巧","level":"4.18","depth":1,"path":"javaScript/灵活运用JS开发技巧.md","ref":"javaScript/灵活运用JS开发技巧.md","articles":[]},"dir":"ltr"},"config":{"plugins":["sectionx","splitter","tbfed-pagefooter","toggle-chapters","theme-comscore","-lunr","-search","search-plus","donate","anchor-navigation-ex","expandable-chapters","chapter-fold","expandable-chapters-small","livereload"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"tbfed-pagefooter":{"copyright":"Copyright &copy zhengyuliang","modify_label":"该文件编写时间：","modify_format":"YYYY-MM-DD HH:mm:ss"},"chapter-fold":{},"pluginsConfig":{"anchor-navigation-ex":{"showLevel":false,"showGoTop":true,"isRewritePageTitle":true,"isShowTocTitleIcon":true,"tocLevel1Icon":"fa fa-hand-o-right","tocLevel2Icon":"fa fa-hand-o-right","tocLevel3Icon":"fa fa-hand-o-right"}},"livereload":{},"splitter":{},"donate":{"title":"","button":"赏","wechat":"https://gitee.com/htzyl/img_bed/raw/master/pay/weixin-min.jpg","alipay":"https://gitee.com/htzyl/img_bed/raw/master/pay/alipay-min.jpg","wechatText":"微信打赏","alipayText":"支付宝打赏"},"fontsettings":{"theme":"white","family":"sans","size":2},"sectionx":{"tag":"b"},"highlight":{},"anchor-navigation-ex":{"showLevel":true,"associatedWithSummary":true,"mode":"float","showGoTop":true,"printLog":false,"multipleH1":true,"float":{"floatIcon":"fa fa-navicon","showLevelIcon":false,"level1Icon":"","level2Icon":"","level3Icon":""},"pageTop":{"showLevelIcon":false,"level1Icon":"","level2Icon":"","level3Icon":""}},"theme-comscore":{},"expandable-chapters-small":{},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false},"toggle-chapters":{},"expandable-chapters":{},"search-plus":{}},"theme":"default","author":"zhengyuliang","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"README.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"记录技术文档内容","language":"zh-hans","gitbook":">=3.0.0","description":"记录Gitbook的配置和一些插件的使用","theme-default":{"showLevel":true}},"file":{"path":"javaScript/编写高质量可维护的代码：一目了然的注释.md","mtime":"2021-05-19T12:06:41.421Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-01-06T09:44:01.178Z"},"basePath":"..","book":{"language":""}});
        });
    </script>
</div>

        
    <script src="../gitbook/gitbook.js"></script>
    <script src="../gitbook/theme.js"></script>
    
        
        <script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/js/bootstrap.min.js"></script>
        
    
        
        <script src="../gitbook/gitbook-plugin-sectionx/sectionx.js"></script>
        
    
        
        <script src="../gitbook/gitbook-plugin-splitter/splitter.js"></script>
        
    
        
        <script src="../gitbook/gitbook-plugin-toggle-chapters/toggle.js"></script>
        
    
        
        <script src="../gitbook/gitbook-plugin-search-plus/jquery.mark.min.js"></script>
        
    
        
        <script src="../gitbook/gitbook-plugin-search-plus/search.js"></script>
        
    
        
        <script src="../gitbook/gitbook-plugin-donate/plugin.js"></script>
        
    
        
        <script src="../gitbook/gitbook-plugin-expandable-chapters/expandable-chapters.js"></script>
        
    
        
        <script src="../gitbook/gitbook-plugin-chapter-fold/chapter-fold.js"></script>
        
    
        
        <script src="../gitbook/gitbook-plugin-expandable-chapters-small/expandable-chapters-small.js"></script>
        
    
        
        <script src="../gitbook/gitbook-plugin-livereload/plugin.js"></script>
        
    
        
        <script src="../gitbook/gitbook-plugin-sharing/buttons.js"></script>
        
    
        
        <script src="../gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
        
    
        
        <script src="../gitbook/gitbook-plugin-theme-comscore/test.js"></script>
        
    

    </body>
</html>

